home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / game / role / ldmud-3.2-bin.lha / mud / doc / efun / present_clone < prev    next >
Text File  |  2001-07-09  |  1KB  |  39 lines
  1. PRELIMINARY
  2. SYNOPSIS
  3.         object present_clone (string str [, object env] )
  4.         object present_clone (object obj [, object env] )
  5.  
  6. DESCRIPTION
  7.         This efun searches the inventory of object <env> (default is the
  8.         current object) for an object with a specific blueprint. The first
  9.         object found is returned, otherwise the result is 0.
  10.  
  11.         The blueprint can be specified either by name <str>, or as the same
  12.         blueprint as of object <obj>. The matching criteria in both cases is
  13.         the load_name().
  14.  
  15.         For plain driver this name starts with a '/', for compat-mode
  16.         drivers it doesn't.
  17.  
  18.         Note that in contrast to present(), this efun never searches
  19.         in the environment of <env>.
  20.  
  21. EXAMPLES
  22.         Assume that object 'env' contains the objects /obj/money#8,
  23.         /std/weapon#9, /std/weapon#12 and /obj/key in the given order.
  24.  
  25.           present_clone("/obj/money", env)     --> /obj/money#8
  26.           present_clone("/std/weapon#12", env) --> /std/weapon#9
  27.           present_clone(find_object("/obj/money#14"), env)
  28.                                                --> /obj/money#8
  29.           present_clone("/obj/key#18", env)    --> /obj/key
  30.  
  31.         For compat-mode drivers, remove the leading '/' from the given
  32.         names.
  33.  
  34. HISTORY
  35.         Introduced in 3.2.7
  36.  
  37. SEE ALSO
  38.         load_name(E), present(E)
  39.